home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / dorpch35.arc / README.NOW < prev    next >
Text File  |  1989-03-20  |  5KB  |  112 lines
  1.  
  2.      January 17, 1989    IMPORTANT - PLEASE READ
  3.  
  4.  
  5.      For a description of changes in this release see CHANGES.DOC
  6.  
  7.      Big problems: QuickBASIC 4.0 cannot be used.
  8.                    Please read our comments in the DOC regarding
  9.                    our choice of QuickBASIC 3.0. We are, however,
  10.                    working on routines that may lead to the
  11.                    capability to use QuickBASIC 4.x. No promises !
  12.  
  13.      The files contained herein work with QuickBASIC 3.0 only.
  14.  
  15.      I have included a file: CLE.BAT for compiling and linking the example door.
  16.  
  17.      This is Release 3.4 of DOORPCH. It is a complete replacement for
  18.      any previous version in your possession. The previous version was 3.2
  19.  
  20.      You will require Microsoft (R) QuickBASIC 3.0 compiler to use
  21.      DOORPCH 3.4. All the necessary files are contained within this ARC file and
  22.      should ALWAYS be distributed together as a unit.
  23.  
  24.      Many hours of hard work have gone into this release. The logic contained
  25.      herein came from myself, Terry Shockley and Harold Thompson.
  26.  
  27.      If you have never written a DOOR before then read on in the DOC's and see
  28.      just how easy it is ! We have even provided an example DOOR program
  29.      demonstrating just a few of the capabilities of DOORPCH 3.4 For those of
  30.      you that are upgrading, we have provided you upward compatibility - more or
  31.      less. Most all the functions continue to work. The GETIN2.ASC code has been
  32.      replaced in a small part by DOORPCH.END. The majority and all new code is
  33.      in DORPCH34.EXE which is now used by the QB compiler during compilation.  A
  34.      LINKER.BAT file is provided for you to LINK your program (.OBJ) into an
  35.      executable module (.EXE).
  36.  
  37.      You may have to patch your BRUN30.EXE file. Included are instructions on
  38.      how to do this. If you require a version and/or feel uncomfortable
  39.      modifying yours, then call one of our BBS's and download it. Either include
  40.      the patched BRUN30.EXE with each of your DOORS or provide a way for other
  41.      SysOps to download the patched version.
  42.  
  43.      Please read ALL the DOCS before proceeding. Much has changed. Functionality
  44.      abounds. You really owe it to yourself (and us too!) to read thru this. If
  45.      you have any questions, call one of our BBS's and ask for assistance. If a
  46.      bug is detected, please let us know right away.
  47.  
  48.      NOTE: Seven IMPORTANT new things.......
  49.  
  50.       1)   In your batch files, you MUST now remove the /NETWORK
  51.            parameter if it currently exists. It is no longer
  52.            needed/supported.
  53.            Failure to do this will result in a run-time error.
  54.      
  55.  
  56.  
  57.  
  58.  
  59.  
  60.       2)   Also - AND VERY IMPORTANT -
  61.                   A NEW variable has been added which MUST be set BEFORE
  62.                   the INCLUDE for DOORPCH.BEG. It is NODE%.
  63.                   If your program uses disk data files that must be
  64.                   shared AND you have file locking logic then set
  65.                   NODE% = 1.
  66.                   If you DO NOT have disk data files then set NODE% = 1.
  67.                   If you DO have disk data files AND DO NOT have
  68.                   file locking logic then set NODE% = 0. This variable
  69.                   when set to equal to <1> will allow the DOOR to run
  70.                   on multiple nodes concurrently. If this variable is
  71.                   found set to zero, then DOORPCH will only allow it to
  72.                   run on ONE NODE CONCURRENTLY. Please BE CAREFUL.
  73.  
  74.       3)  On existing DOORPCHn.CFG files used by DOORS LINKed to version
  75.           3.4 of DOORPCH, you MUST delete the first record - COM1 or
  76.           COM2.  This information is obtained from PCBOARD.SYS by
  77.           DOORPCH.
  78.  
  79.       4)  The PROGNAME$ and R.ELEASE$ strings MUST be populated BEFORE
  80.           entering the logic in DOORPCH.BEG. They should be populated
  81.           with your DOOR name and release version respectively.
  82.           (ie PROGNAME$ = "Wizard Adventure": R.ELEASE$ = "6.0").
  83.  
  84.       5)  The PROGB$ string MUST be populated BEFORE entering the
  85.           logic in DOORPCH.BEG. It should be populated with the
  86.           BATCH (or PROGRAM) name. (ie PROGB$ = "TGTRIVIA.")
  87.                                   Note the period (.) ===^
  88.  
  89.       6)  If your DOOR uses the High Score routines provided in an
  90.           earlier version, the bulletin file must be removed. They will
  91.           have a filename ending in .BUL. Example: TGTRIVIA.BUL.
  92.           Failure to do this will result in an ERROR # 5 at run-time.
  93.  
  94.       7)  You MUST set two variables in AUTOEXEC.BAT for your BBS
  95.           system.  At present only PCBoard is supported: Place the
  96.           following statements any place in AUTOEXEC.BAT:
  97.                                    SET DOORPCH=PCB
  98.                                SET LIB=<path to DORPCH34.EXE>
  99.  
  100.      If you get an error during the DOORPCH initialization process it
  101.      is probably due to an incorrectly configured .CFG file or the
  102.      parameter passed to your door (Eg: TGTRIVIA DOORPCH1.CFG) is probably
  103.      incorrect.  It may be due to one of the seven things listed above.
  104.  
  105.      Thanks,
  106.  
  107.      Clint Labarthe, Black Hole BBS,    (407) 260-6397
  108.      Terry Shockley, The Death Star BBS, (407) 660-6300
  109.  
  110.  
  111.  
  112.